home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / hsc / source / riscos / ReadMe < prev    next >
Encoding:
Text File  |  1997-05-18  |  2.1 KB  |  69 lines
  1. Preparing the sources for compilation
  2. =====================================
  3.  
  4. The sources of hsc come in Unix filename conventions (ie. '/c' and '/h'
  5. extensions) so you need to convert them to RISC OS format (ie. directories
  6. 'c', 'h' and 'o'). The RunMe1st Obey file does this automatically, it scans
  7. all the source directory, renames the files accordingly and creates the 'o'
  8. directories where needed. It also sets the filetype of MakeStubs (see below)
  9. and copies the Makefile from the 'riscos' directory to the upper directory
  10. from where you can run it.
  11.  
  12. Note that you need a filing system that supports names longer than 10
  13. characters in order to compile hsc (eg. use LongFiles on FileCore discs or
  14. an image filing system such as X-Files or SparkFS). Actually names longer
  15. than 10 characters are only present before the files are moved to the 'c' and
  16. 'h' directories, once you have executed the RunMe1st file you can copy the
  17. sources to any filing system.
  18.  
  19.  
  20. Making o.UnixStubs
  21. ==================
  22.  
  23. You will need to make o.UnixStubs before you can compile this program.  This
  24. is a patched SharedCLibrary.
  25.  
  26.  
  27. Semi-Automatic
  28. --------------
  29.  
  30. Copy your Cv5 o.Stubs from their normal place into the o directory as
  31. UnixStubs.
  32.  
  33. Show the Filer the !Patch application (comes with all versions of RISCOS)
  34.  
  35. Double click on the MakeStubs patch file.
  36.  
  37. Drag o.UnixStubs onto Patch, tick the patch and then choose to patch all
  38. from the menu.
  39.  
  40.  
  41. Manual
  42. ------
  43.  
  44. Copy your Cv5 o.Stubs from their normal place into the o directory as
  45. UnixStubs.
  46.  
  47. Load it into a text editor.
  48.  
  49. Change the occurrence of
  50.   fopen   --> gopen
  51.   freopen --> greopen
  52.   rename  --> gename
  53.   remove  --> gemove
  54.  
  55. Save the file.  Note that you shouldn't have made the file any longer in the
  56. process and you should only have changed 4 bytes.
  57.  
  58.  
  59. Compiling the sources
  60. =====================
  61.  
  62. Just set the CSD in the 'source' directory and execute 'amu' or double click
  63. the Makefile. At the end of the compilation you'll find the three executables
  64. 'hsc', 'hscdepp' and 'hscpitt' in the main hsc directory (ie. one level above
  65. 'source').
  66.  
  67. Currently only the Acorn C V5 compiler has been tested but probably also
  68. Acorn C V4 will be able to compile hsc.
  69.